<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
<HTML><HEAD>
<TITLE>IBM Visualization Data Explorer Programmer&#39;s Reference</TITLE>

<META HTTP-EQUIV="abstract" CONTENT="IBM Visualization Data Explorer
Programmer&#39;s Reference">
<META HTTP-EQUIV="contact" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="owner" CONTENT="IBM Visualization Data Explorer
(ibmdx@watson.ibm.com)">
<META HTTP-EQUIV="updated" CONTENT="Tue, 16 Sep 1997 ">
<META HTTP-EQUIV="review" CONTENT="Fri, 14 Aug 1998 ">

<META HTTP-EQUIV="keywords" CONTENT="GRAPHICS VISUALIZATION VISUAL PROGRAM DATA
MINING">
<meta http-equiv="content-type" content="text/html;charset=ISO-8859-1">
</HEAD><BODY BGCOLOR="#FFFFFF">

<A NAME="Top_Of_Page"></A>
<H1>IBM Visualization Data Explorer Programmer&#39;s Reference</H1>
<B>&#91; <A HREF="#Bot_Of_Page">Bottom of Page</A> &#124; <A
HREF="progu177.htm">Previous Page</A> &#124; <A HREF="progu179.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B><HR><P>
<H3><A NAME="HDRDXGICA"
HREF="progu097.htm#PToC_272">DXGetInvalidComponentArray</A></H3>
<A NAME="IDX1745"></A>
<A NAME="IDX1746"></A>
<P><STRONG>Function</STRONG>
<P>
Returns an Array containing the information stored in an
invalid-component handle.
<P><STRONG>Syntax</STRONG>
<BR>
<TT><STRONG><BR>
&#35;include &lt;dx/dx.h&gt;<BR>
<P><BR>
Array DXGetInvalidComponentArray(InvalidComponentHandle handle)<BR>
</STRONG></TT><BR>
<P><STRONG>Functional Details</STRONG>
<P>
The returned Array may be dependent or referential (see
<A HREF="progu066.htm#HDRPROCHAP">Chapter 14. "Data Processing"</A>).
If <TT><STRONG>handle</STRONG></TT> was created using a Field, then the
Array will contain the appropriate "dep" or "ref"
attributes.
However, if <TT><STRONG>handle</STRONG></TT> was created using only an Array,
then this routine cannot determine whether the returned Array is
dependent or it references "positions" or
"connections," and it is up to the
calling program to set the
appropriate attribute.
The determination of should be based on the type of the Array; if it is
<TT><STRONG>TYPE_UBYTE</STRONG></TT> or <TT><STRONG>TYPE_BYTE</STRONG></TT>,
it is dependent;
if it is <TT><STRONG>TYPE_UINT</STRONG></TT> or
<TT><STRONG>TYPE_INT</STRONG></TT>,
it is referential.
<P><STRONG>Return Value</STRONG>
<P>
Returns the Array or returns <TT><STRONG>NULL</STRONG></TT> and sets
an error code.
<P><STRONG>See Also</STRONG>
<P>
<TT><STRONG>
<A HREF="progu126.htm#HDRDXCICH">DXCreateInvalidComponentHandle</A>,
<A HREF="progu150.htm#HDRDXFICH">DXFreeInvalidComponentHandle</A>,
<A HREF="progu205.htm#HDRDXGTE">DXGetType</A>
</STRONG></TT>
<P>
<A HREF="progu068.htm#HDRINVDATA">14.3 , "Invalid Data"</A>.
<P><HR><B>&#91; <A HREF="#Top_Of_Page">Top of Page</A> &#124; <A
HREF="progu177.htm">Previous Page</A> &#124; <A HREF="progu179.htm">Next
Page</A> &#124; <A HREF="../proguide.htm#ToC">Table of Contents</A> &#124; <A
HREF="progu097.htm#PToC20">Partial Table of Contents</A> &#124; <A
HREF="progu344.htm#HDRINDEX_START">Index</A> &#93;</B> <br><b>&#91;<a
href="../allguide.htm">Data Explorer Documentation</a>&nbsp;&#124;&nbsp;<a
href="../qikguide.htm">QuickStart Guide</a>&nbsp;&#124;&nbsp;<a
href="../usrguide.htm">User&#39;s Guide</a>&nbsp;&#124;&nbsp;<a
href="../refguide.htm">User&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../proguide.htm">Programmer&#39;s Reference</a>&nbsp;&#124;&nbsp;<a
href="../insguide.htm">Installation and Configuration
Guide</a>&nbsp;&#93;</b><br><p><b>&#91;<a
href="http://www.research.ibm.com/dx">Data Explorer Home
Page</a>&#93;</b><p><HR ALIGN=LEFT WIDTH=600><b>&#91;<A
HREF="http://www.ibm.com/">IBM Home Page</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Orders/">Order</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Search/">Search</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Assist/">Contact IBM</A>&nbsp;&#124;&nbsp;<A
HREF="http://www.ibm.com/Legal/">Legal</A>&nbsp;&#93;</b><hr><p>
<A NAME="Bot_Of_Page"></A>
</BODY></HTML>
